package com.papercutting.platform.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.papercutting.platform.dto.query.UserQuery;
import com.papercutting.platform.entity.User;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 用户Mapper接口
 */
@Mapper
public interface UserMapper extends BaseMapper<User> {
    
    /**
     * 分页查询用户列表
     *
     * @param page  分页参数
     * @param query 查询条件
     * @return 分页结果
     */
    IPage<User> selectUserPage(Page<User> page, @Param("query") UserQuery query);
    
    /**
     * 根据条件查询用户列表
     *
     * @param query 查询条件
     * @return 用户列表
     */
    List<User> selectUserList(@Param("query") UserQuery query);
    
    /**
     * 根据用户名查询用户
     *
     * @param nickname 用户名
     * @return 用户信息
     */
    User selectByNickname(@Param("nickname") String nickname);
    
    /**
     * 根据手机号查询用户
     *
     * @param phone 手机号
     * @return 用户信息
     */
    User selectByPhone(@Param("phone") String phone);
    
    /**
     * 根据邮箱查询用户
     *
     * @param email 邮箱
     * @return 用户信息
     */
    User selectByEmail(@Param("email") String email);
    
    /**
     * 统计用户数量
     *
     * @param query 查询条件
     * @return 用户数量
     */
    Long countUsers(@Param("query") UserQuery query);
    
    /**
     * 批量更新用户状态
     *
     * @param userIds 用户ID列表
     * @param status  状态
     * @return 更新数量
     */
    int batchUpdateStatus(@Param("userIds") List<Long> userIds, @Param("status") Integer status);
}